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An introduction to Java applets 
and appiications 



By Probal Shome 

One reason for all the hoopla 
regarding Java is that it holds 
great promise — the promise of 
machine independence. You're sup- 
posed to be able to write an applet 
on one of many platforms (from a 
PC running Windows 95 to an IBM 
mainframe running MVS) and 
instantly achieve cross-platform 
portability of the applet to all plat- 
forms on which the Java Virtual 
Machine (JVM) is implemented. 

In this article, we'll show you 
some of the basics of creating Java 
applets and applications. We assume 
that you have a working knowledge 
of C and object-oriented concepts, 
such as class, objects, methods, 
attributes, and inheritance. 

We'll first build the tradi- 
tional "Hello, World!" applet and 
present some variations. Next, 
we'll build a standalone Java ap- 
plication version of the "Hello, 
World!" program. Finally, we'll 
add the ability to display text that 
the user enters. 



Installing Java 

If you don't have Java installed, 
you'll have to download the Java 
Development Kit (the latest ver- 
sion at the time of this writing is 
vl.0.2) from http://java.sun.com/ 
java.sun.com/products/JDK/index. 
html. Note to x86 users: Starting 



with JDK vl.0.2. Sun provides a 
version that runs on the Intel 
platform. 

Quick introduction 

Writing a Java applet is similar to 
using a third-party application 
toolbox with C++. Many of these 
provide a base class that manages 
the nuts-and-bolts details of an 
application, and you provide the 
code that makes the application do 
something interesting. Similarly, 
Java provides the base class Applet, 
which provides the basic details in 
telling the application how to open 
a window, redraw itself, and other 
general features. When you create a 
Java applet, you typically just ex- 
tend the Applet class. 

When you create a new class 
in Java, the new class must be in a 
file named ClassName.java, where 
ClassName is the name of the class 
you're creating. You can compile 
the ClassName.java file using j avac 
to get the ClassName. class file, 
which holds the compiled JVM 
code. You can then run the code in 
ClassName. class with the Java in- 
terpreter, or if you have an HTML 
document that specifies it, you can 
view it with an HTML browser that 
supports Java, such as Hotjava or 
Navigator. The JDK also comes 
with an applet viewer, which will 
execute Java applets specified in an 
HTML document. 
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The main difference between a 
Java applet and a Java application is 
that an applet needs to be run from 
a supporting program, such as a 
browser or the Java applet viewer 
program. A Java application may be 
run from the Java interpreter. An 
applet relies on the browser for sup- 
porting code, where an application 
is self-sufficient. 

A short note about comments — 
Java recognizes three styles of 
comments: text enclosed by and 

text after // till the end of the 
line, and finally, text enclosed by 

and which has a special 
significance for the j avadoc tool 
that generates documentation for 
Java applets. Since Java contains 
no preprocessor, weTl use /"^ and 

to block out chunks of code, 
which we would do in C using 
#if 0 ... #en(iif. Since and V 
pairs do not nest, weTl leave them 
for block quotes and use // for 
line-at-a-time comments. 

QUICK TIP: Note that Java, Uke 
C/ C++, is case-sensitive. The words 
Class and class are different words. 
The Java tools (like the Java compiler 
j avac) are also case-sensitive. 

The HelloVUbrld applet 

Let's start by writing a simple 
applet that displays the string 
"Hello, World!'' Figure A shows 
the code for our first Java applet. 
Hello World. java. 

The first two statements import 
the Applet and Windowing classes 
that we're building upon for our 
example. You must include them, 
or the applet won't work. The 



Abstract Windowing Toolkit 
(AWT) provides the windowing 
user interface to our Java applet. 

Next, we tell Java we're creat- 
ing a new applet class named Hello- 
World by inheriting all useful 
methods (ways of doing things) from 
the generic Applet class. We redefine 
the way this applet displays itself 
on the screen by providing a new 
version of the pa i n t ( ) method. We 
use the drawString( ) method to 
display the text inside the applet's 
paint( ) method. 

Using a text editor, we type the 
Java code above into a text file 
called Hello World, java. We then 
compile the code by typing 

$ javac HelloWorld. java 

If the /java/bin directory isn't 
included in your PATH variable, 
you'll have to specify the complete 
path to j avac, like this: 

$ /java/bin/javac He I loWor Id . j ava 

If javac compiles the code 
and finds no errors, it creates a 
file named Hello World. class in the 
current directory. In order to run 
the applet, we need to create an 
HTML document telling the brow- 
ser to run the applet. To do so, 
create the file Hello World. html in 
the current directory. Figure B 
shows the contents of the new 
HelloWorld.html file. 

If you open this HTML file in 
your Java-enabled Web browser, 
you should see your first Java 
applet! You can execute this applet 



Hgure A 

import java. applet, 
import java.awt.* ; 



; // Remember the import statements 
// .. Abstract Windowing Toolkit 



public class HelloWorld extends Applet { 
// Display the applet using this method 
public void pai nt(Graphi cs g) { 
g. drawstring ("Hello, World!", 50, 75 )• 

} 

J 

Our first Java applet simply displays a text string in the paint( ) method 
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with the a p p I e t V 1 e we r program Uke this: 

$ appletviewer HelloWorld.html 

Once you do so, you'll see the window shown 
in Figure C appear on your screen. 

For each new applet in this article, you'll 
have to create a new HTML file that looks like 
HelloWorld.html changing only the name of the 
class in the APPLET tag. You can, of course, 
name the HTML files anything you choose. 

HelloWorld: Where did the 
applet go? 

Next, we'll change the foreground and 
background colors of the HelloWorld applet 
and examine an interesting technique for 
visually integrating Java applets into a Web 
page. While we could simply add some code 
to our Hello World. java program, we'll use this 
opportunity to show how easy it is to extend 
an existing class. So rather than modifying 
Hello World. java, we'll create a new file, called 
Color Jiello World. java, that extends Hello- 
World.java. Figure D contains the code for our 
Color _Hello World applet. 

As you can see, we merely redefine the 
1 n 1 1 ( ) method that the Applet class executes 
when it starts. You may be wondering (if 
you've not seen it in C++) what the keyword 
this denotes in the listing in Figure D. It's a 
self-reference that is implicitly passed to each 
method (operation) of the current object, i.e., 
this object — the object for which we're de- 
fining the method or operation. In this case, 
the keyword this translates into a reference to 
the Color JHello World applet. And so, the fore- 
ground and background colors of this Color _ 
HelloWorld applet are set. 

We use the setBackgrouncl( ) and the 
setForeground( ) methods to change the 
background and foreground colors of the 
Applet window. (For some color definitions, 
see the sidebar "Standard Java Colors" on 
page 4.) The java. awt. Component package 
defines the setBacl(ground( ) and setFore- 
ground( ) methods. All GUI widgets, except 
menu components like menubar and menu- 
items, descend from the Component class. 
Thus, these two operations work on all these 
widgets, including applets. 

The subclass-superclass relationship uses 
the ISA hierarchy model. In the ISA hierarchy 
model, a subclass is a (ISA) specialization of 
its superclass. For example, if you have the 
class hierarchy shown in Figure E, you can see 



Figure B 

<HTML> 

<APPLET code="HelloWorld. class" width=150 height=100> 

</APPLET> 

</HTML> 

This HTML document tells the browser to run the applet code found in 
HelloWorld. class in a 150x100 window. 



Hgure C 



Applet Viewe 



Applet 



Hella World! 



Applet started. 



Here's the result of our HelloWorld 
applet. 



Figure D 

import java. applet, 
import java.awt.* ; 



public class Colorjel loWorld extends HelloWorld { 
// Set the background and foreground colors 
public void ini t( ) { 

// match your browser background 

this.setBackground(Color .whi te); 

// whatever foreground color suits your fancy 

this. setForeground(Color .blue); 
} 

J 

The Color_HelloWorld applet modifies HelloWorld by changing 
the foreground and background colors. 




This hierarchy of edibles illustrates the ISA hierarchy model. 
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that a Mango is a Fruit. So the Fruit class 
(collection of all fruits) is a superclass of the 
Mango class (collection of all mangoes). The 
Mango class is a subclass of the Fruit class. 

Similarly, an Applet ISA Panel (defined 
as a Container that's nested inside another 
Container) ISA Container ISA Component. 
This is the subclass-superclass chain that 
leads from an Applet up to a Component. 
This example gives you an idea of the 
hierarchical structure of the elements of the 
GUI interface. It extends to all aspects of 
Java, since it is an object-oriented language. 

After this diversion into class hierarchies, 
let's get back to the Color _Hello World applet. 
Notice how we set the background color to 
white, so that it matches the browser's de- 
fault background. Suddenly the text dis- 
played inside the applet seems to be floating, 
since we can no longer see the boundaries of 
the applet within the Web page. This trans- 
parency effect is really striking for animated 
applets. (If your browser uses a default back- 
ground other than white, you may want to 
change it to white for the duration of this 
demonstration.) 

Building our first Java appiication 

Now that we've built our Hello World applet 
and extended it, it's time to see how to create 
a standalone application. Let's build a stand- 
alone version that can be directly executed by 



Standard Java coiors 



The package java.awt, Color provides access to 
all the color capabilities of the Applet environ- 
ment. While you can create any colors you 
want, java.awt.Color provides a few predefined 
colors for you: 

Color.black Color.green Color.pink 
Color.blue Color.lightCray Color.red 
Color.cyan Color.magenta Color.white 
Color.darkCray Color.orange Color.yellow 
Color.gray 

You can look up these constants, as well as 
all the methods for the Color class, in the API 
documentation available from http://java.sun. 
com/java.sun.com/newdocs.html. Please note that 
these colors may appear slightly different on 
various video card/ monitor combinations, as 
few are calibrated. 



the Java interpreter, outside the browser. To 
start, create the text file named Hello World- 
App.java, as shown in Figure F. 



Figure F 



// Note the absence of import packages 
class Hel loWorldApp { 

// We must define main() which gets 
// executed by default. 

public static void main (String argsll) { 

System. out. println ("Hello, World!" ) ; 

} 

} 

HelloWorldApp.java is our first Java appiication. 

For our application, we forgo the niceties 
of a windowing system. This Java application 
is much closer to the traditional "Hello, 
World!" application. 

System. out is analogous to the standard 
output stream (STDOUT) used in C/C++, 
p r i n 1 1 n ( ) starts a new line after the text, just 
as if you used p r i n t f ( ) in C and appended a 
newline (\n) to the format string. We compile 
the application using j a vac as before. How- 
ever, we run it differently, by executing the 
Java interpreter: 

$ java Hel loWor IdApp 
Hello, World! 

As you can see, the result is that the text 
"Hello, World!" gets printed. Here we've built 
a text-mode application, but this shouldn't 
lead you to conclude that Java applications are 
restricted to text mode. They can have graph- 
ical user interfaces as well. In fact, we'll build 
one in the next section. 

Adding an input text field 

We'll now build a Java application that al- 
lows you to type text in a field, which it then 
displays in a different pane. To do so, we 
implement a special kind of frame for our ap- 
plication. A frame is defined as an optionally 
resizable top-level application window. We'll 
define a subclass of the Frame class called 
TextFieldApp. 

Each such frame will contain a text field for 
the user to type in text and a text area for the 
text to be displayed. We create the frame, then 
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add the text area and text field to it, after hav- 
ing customized them both for our purposes. 
We add them so that the text area is at the top 
of the frame, and the text field is at the bottom. 
Java will automatically do the layout for us. 
There are more complicated layout managers 
in Java, which allow the specification of elabo- 
rate layout constraints. These are useful for lay- 
ing out windows containing several components. 

Since this is a standalone Java application, 
we must define a ma i n ( ) method, in which we 
create, resize, and paint the frame. Finally, we 
need to write an event handler. In this case, the 
event handler is simpler than usual, since 
we're not concerned about mouse-clicks, key- 
board events, or windowing events (like the 
window being moved). If we'd been interested 
in those events, we'd most probably have rede- 
fined the handle-Event( ) method. Since we're 
interested only in copying the text entered in 
the text field to the text area, we can take a 
shortcut and redefine the act i on( ) method to 
copy the text when necessary. 

The code for our TextFieldApp.java pro- 
gram is shown in Figure G. Notice that we've 
left out, for the purposes of this exercise, 
elementary components of the window, such 



as a menu bar that would allow us to choose 
to quit the application. 

Now you can compile and run the 
TextFieldApp.java program using the commands 

$ javac TextFieldApp.java 
$ java TextFieldApp 

When you do so, you'll see the window shown 
in Figure H. To play with the application, type 
in some text in the lower text field, and press the 
[Enter] key. You should see the text in bigger 
letters echoed in the text area above. You'll have 
to kill this window manually, since we haven't 
implemented an OK button or a Quit menu item. 



Figure H 




Displays happen here! 



Here's what our Java application lool<s lil<e when it first starts running. 



Figupe G 

import java.awt.* ; 

public class TextFieldApp extends Frame { 

TextField textfield ; // For typing in text 
TextArea textarea ; // and displaying it... 
Font textareafont ; 

public TextFieldApp (String title) { 

// Create a Frame with the title 
super(title) ; 

// Add text field and textarea 
textfield = new TextField ("Enter text:", 40); 
textarea = new TextArea ("Displays happen here!", 
5, 40) ; 

textarea. setEdi table( false); // Don't allow user to 

// modi f y i t ! 
tex t area. setBackground(Co lor. wh i te) ; 
textarea . setForeground(Co lor .black) ; 
textfield .set Foreground(Color. black) ; 

// Set BIG font for display of textarea. 
textareafont = new Font( "Courier", Font. BOLD + 

Font. ITALIC, 36) ; 
tex t a rea.setFont( textareafont ) ; 

// Add these elements to the current frame. 

this.add("North", textarea) ; 

this.add("South", textfield); // very simple layout 




} // end TextFieldApp( ) method 

// All applications must have the main() method, 
public static void main(String args[]) { 

Frame f = new TextFieldApp ("First GUI 
^Application"); 

f.pack(); // Resize to appropriately small size, 
f .show( ); 

} // end main( ) method 

// Handle text being typed in, and transfer it to 
// the text area. 

// The more generic method called hand leEvent( ) 
// can handle keyboard & mouse events and would 
// be needed for more complex windows, 
public boolean action (Event event. Object argument) { 

// Text typed into text field ? 
if (event . target == textfield) { 
// Display text 

textarea. setText((String)argument + "\n" ) ; 
return true; 

} 

else { return false ; } 
} // end action( ) method 
} // end TextFieldApp class 



This Java application copies any text entered into the text field to the text area. 
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Information resources 

You can find many auxiliary sources of infor- 
mation about Java on the Internet. If you're 
interested in the cross-platform aspects of Java 
development, you can keep abreast of the JVM 
porting efforts for different platforms in the 
document http://java.sun.com/java.sun.com/Mail/ 
external_lists.html. 

For a registry of many existing Java applets 
(along with the source code for many of them), 
you'll want to visit http://www.gamelan.com/ . 
Also, check out http://java.sun.com/java.sun.com/ 
applets /index. html for an index of many Java 
applets you can tinker with. 

Don't forget to check your local bookstore 
for books on Java. Unless your bookstore is 
horribly out-of-date, there'll be about a trillion 
different books on Java. Be careful before you 



buy a Java book: Since Java is the current fad 
language, many books on it are junk. 

Conclusion 

We've shown you how to build simple Java 
applets and standalone applications. We also 
demonstrated how to extend an existing 
applet for which we had the Java source code. 
Finally, we explained how to create a Java 
application. Since the JDK is freely available 
on the Internet, and there are versions for both 
Sparc and Intel, you have no excuse not to 
download it and start playing with it! ❖ 

Probal Shome is a Senior Technical Analyst with 
Oracle Worldwide Support. You can reach him at 
pshome@us.oracle.com. 
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Clianging llie tide bar of an xterm winilow 



Figure A 



if you use OpenWindows, you've probably 
had lots of Command Tool and Shell Tool 
windows open at the same time. If you 
have enough of them on the screen, it can 

get pretty confus- 
ing. The more win- 
dows you have 
open, the less of 
each window you 
can see before they 
overlap. Which one 
are you using for 
which project? Fig- 
ure A shows the 
windows overlap- 
ping with only the 
title bars showing. 

As you can see, 
all the title bars 
show the same 




Whiile it's tiandy to tiave thie ability to use 
multiple windows to do your job, it can be 
confusing. 



information: shelltool - /bin/ksh. The title 
bar is supposed to be informative, but it's 
telling us only that it's a Shell Tool window 
running /bin/ksh. The Command Tool and 
Shell Tool programs, among others, both use 
an xterm window for I/O. In this article, we'll 
show you how to change the title bar for an 
xterm window to anything else you want. 



Changing tlie text of an xterm 
winilow 

It turns out that an xterm window treats the 
title bar and the normal window area as two 
different windows. The xterm provides a 
special character sequence you can use to put 
text in the alternate window (i.e., the title bar) 
and another character sequence to tell the 
xterm when to go back to the original window. 

The sequence of characters you use to tell 
the X t e r m to start putting text in the title bar is 
[Esc], ], then 1. You then may send it the text you 
want on the title bar. When you're finished, send 
the xterm an [Esc] character followed by \. 

For example, if you're using Open- 
Windows, start a Shell Tool and type the 
following command: 

$ echo llNew Titlebar Text^[\\" 

When you press the [Esc] key, the xterm 
window displays ^[. Also, the shell interprets the 
\ character as an escape, which tells it to treat 
the next character as if it had no special mean- 
ing. In order to send the \ character to the echo 
command, you need to use two \ characters: 
The first tells it the next character has no special 
meaning; the second is the character itself. 
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A quick shell script 

Actually remembering and typing the appro- 
priate escape sequences is no great hardship. 
However, it makes things simpler to make a 
shell script to do the job for you. Figure B 
shows the shell script WinName, which will 
name a window for you. 

Keep in mind that ^[ is the [Esc] key, not 
the keys [Ctrl] and [. If you're using vi to enter 
the shell script, just press [Ctrl]-V before 
pressing the [Esc] key to enter it. One last 
note: We're comparing the TERM environment 
variable tosun-cmd because the termcaps entry 
for an xterm is sun-cmd. 

If you use this script, you won't have to 
remember the escape sequences, and you won't 
have any problems if you mistype something. 
If you mistype the [Esc]\ part, for example, 
you'll lose some of your output from successive 
commands, as the output will go to the title 
bar. However, the xterm doesn't actually 
change the title bar until it receives the [Esc]\ 
character sequence, so you won't see a change. 

Once you enter the shell script, don't forget 
to make it executable with the command 

$ chmod +x WinName 

When you use this script, you need to keep 
something in mind: If you want spaces in 



your text, en- 
close the new 
window title in 
quotes. Other- 
wise this script 
will set the win- 
dow title to the 
first word only. 

Conclusion 

Remember the 
ugly screen 
shown in Fig- 
ure A? Figure 
C shows the 
same screen, but 
with informa- 
tive title bars. 

You can use 
this technique to 
put any informa- 
tion in the title 
bar of your 
xterm windows. 
Once you do so, 
you'll find it 
much easier to 
locate the window 
now describes the 



Rgure B 



if [ $TERM = "sun-cmd" ]; then 

echo "'^[jl" $1 "'^[W" 
else 

echo "Sorry, you can only use this in a 
^sun-cmd window" 
fi 

This short shell script will change the title bar in a 
sun-cmd (i.e., xterm) window. 



Figure C 




It's much easier to find the window you want when 
the title bars have useful information in them. 



you want, since the title bar 
window. ❖ 
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Using commamHine 
Korn shel 

By AI Alexander 

Recently, someone cornered me and asked 
why UNIX doesn't provide command- 
line history like DOS does. In DOS, after 
you execute the DOSKEYS command, you can 
recall and edit command lines. Actually, UNIX 
does provide a similar capability. As I spend 
most of my day working at the command line 
in the Korn shell, life with Solaris would be far 
more difficult without the command-line 
history feature. 

However, command-line history works 
differently depending on which shell you're 
using. In this article, we'll show you how to 
enable and use command-line history in the 



Korn shell. Next month, we'll show you how 
to use command-line history in the C shell. 

Enabling command-line history 

The Korn shell provides a very sophisticated 
command-line history mechanism. Using it, 
you can retrieve previously entered commands, 
as well as edit and execute them. You can use 
two primary modes, v i and ema c s mode. (There's 
also a g macs mode, but it's nearly identical to 
ema OS mode.) 

These modes allow you to edit the com- 
mand line as if you were using the editor 
named. For example, in vi mode, the Korn 
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shell uses insert and command modes for the 
editor, just like v i . To enter command mode, 
you press the [Esc] key. Then you can use the 
normal cursor-movement keys for moving 
around and editing text. You can go back to 
insert mode by pressing z, a, or A, just as 
you'd expect. Table A shows a subset of the 
editing commands you can use in v i and 
emacs modes. 

If you use either vi or emacs as your 
editor-of-choice, it's easy to select which mode 
to use. If you use another editor, like the CDE 
text editor, youTl just have to choose the one 
you like better. It may be worthwhile checking 
them both out. 

It's very easy to enable the command-line 
history feature in the Korn shell. All you need 
to do is set the environment variable VISUAL to 
the mode you'd like to use: emacs, gmacs, or vi . 
Let's try it out. If you're not already in the 
Korn shell, enter it by typing 

$ ksh 

Now let's enable the command-line 
editing mode. For this demonstration, we'll 
use V i mode. 

$ VISUAL=vi 

To demonstrate the re-use of previously 
entered commands, let's first create a brief 



three-command history. Type in the following 
three UNIX commands, and then we'll show 
how to easily re-use these commands within 
the Korn shell: 

$ Is -al 
$ ps -ef 
$ who 

Now that we've put some commands in 
your history, let's call up the last command we 
entered, who. To do so, press the [Esc] key, 
then press k. You should then see the who 
command, with the cursor on the w. At this 
point, you're in a one-line version of the v i 
editor. The history list is treated hke a file, and 
your command line is like a one-line view port 
into this file. You begin in v i 's insert mode, so 
pressing the [Esc] key puts the editor into 
command mode. Pressing the k key moves 
you up a line to the previous command. If you 
press k again, you'll go up to another com- 
mand, in this case ps -ef. Press k again, and 
you'll see the Is -a I command again. Press / 
to go to the next command, and you'll be back 
at the ps -ef command. 

As in the regular v i editor, typing a 
capital A allows you to append to the end of 
the current line. Go ahead and type a capital 
letter A, then type 



more 



Table A 


1 Description 


VI (insert mode) i 


vi (command mode) 


emacs 1 


Retrieve next command 


n/a 


i 


[Ctrl]-N 


Retrieve previous command 


n/a 


k 


[Ctrl]-P 


Move left one character 


n/a 


h 


[Ctrl]-B 


Move right one character 


n/a 


1 


[Ctrl]-F 


Move left one word 


n/a 


b 


[Esc]b 


Move right one word 


n/a 


w 


[Esc]f 


Enter insert mode 


n/a 


i, a, A 


n/a 


Exit insert mode 


[Esc] 


n/a 


n/a 


Go to start of line 


n/a 


A 


[Ctrl]-A 


Go to end of line 


n/a 


$ 


[Ctrl]-E 


Execute command 


[Enter] 


[Enter] 


[Enter] 


Delete current character 


n/a 


X 


[Ctrl]-D 


Delete current word 


n/a 


dw 


[Esc]d 


These are some of the most-commonly used command-line editing commands in vi and emacs. 



Now your com- 
mand line should look 
like this: 

$ Is -al I more 

You can execute the 
command by pressing 
the [Enter] key. 

The capabilities 
you just saw are some 
of the things that 
make this feature so 
desirable. The vi edi- 
tor offers many other 
capabilities, such as 
searching for pre- 
vious commands with 
the / character, that 
make the command- 
history editing fea- 
ture very powerful. 
Just as the v i editing 
mode is powerful, 
emacs mode provides 
similar features. 
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Once you enable the command-line 
history editing mode, you not only gain 
the ability to retrieve previous commands 
and edit them, you also get the ability to 
edit the line you're currently working on. 
If youVe entered 30 or so characters and 
notice that the first character is wrong, you 
can simply go to the start of the line, edit 
the character, then go back to the end and 
continue typing. 

Terminal requirements 

For the in-place command-line editing to 
work, your terminal must support two basic 
features. First, your terminal must not auto- 
matically advance to the next line when it re- 
ceives a carriage return without a new Hne. 
Second, when your terminal prints a space, it 
must overwrite the character that was origi- 
nally at the location. These two features allow 
you to use in-place command-line editing by 
allowing the terminal to update the command 
line as it's being edited. 

Editing a very long line 

As a result of the modest requirements the 
in-place command-line editing feature places 
on your terminal, the Korn shell uses only 
one physical line when you edit a command 
Hne. As you notice, the terminal isn't re- 
quired to have a character used to move the 
cursor up a line. Since the cursor motion is 
limited to left (via the carriage return), right 
(by printing characters), and down (via the 
new line), the Korn shell uses a single line on 
your terminal. Otherwise, in-place editing for 
long command lines would be impossible. 
When you're editing a command line larger 
than the width of your terminal, the Korn 
shell displays a special character at the right 
margin to tell you so. 

If you're at the start of the long command 
line, the Korn shell displays a > at the right 
margin to show you that there's more com- 
mand line to the right. If you're at the end of 
the long command line, you'll see a <, show- 
ing you that there's more command line to the 
left of the left margin. If your command line is 
so large that it extends past both the left and 
right margins, the Korn shell will display an 
at the right margin. 

Unless you tell it otherwise, the Korn shell 
assumes that your terminal is 80 characters 
wide. You can specify the size by setting the 
COLUMNS variable. Let's try an example just to 
see how the Korn shell handles a very long 



Hne. We're going to use the v i editing mode in 
this example. First, let's start the Korn shell, 
set V i mode for command-line editing, and set 
the column width to 40 so we don't have to 
use an exorbitantly long command line: 

$ ksh 

$ VISUAL=vi 
$ COLUMNS=40 

Now, let's enter a relatively long 
command line: 

$ now is the time for all good men to come to 
^the aid of their party. 

When you enter this command line, you'H see 
it in its entirety, even if it wraps to the next 
line. Now press the [Esc] key, then the k key to 
invoke the command-line editor. When you 
do so, you'll see 

$ now is the time for all good men to> 

The > symbol indicates that the command 
line extends past the right margin. If you use 
the L key to advance the cursor to the space 
after the word to, you'll see 

$ r all good men to come to the aid o* 

Now, press A to start editing at the end of 
the line. When you do, you'll see 

$ id of their party. < 

Tiie command-iine liistory 

If you'd like to examine the last few com- 
mands you've entered, you can type 

$ history 

This will print the last few commands that 
you've entered. 

Each time you start the Korn shell, it loads 
the command-line history from the previous 
session. This makes life much simpler if you 
tend to do the same operations over and over. 
Rather than having to type them in again, you 
can access the commands you used in a pre- 
vious session. 

Unless you override it, UNIX stores your 
command-line history in the file .shjiistory. 
You may override it by setting the HI ST FILE 
environment variable to the name of the file 
you'd rather use. You can use this feature to 
set up different command-line histories for 



different terminal windows. Thus, if you tend 
to work on multiple projects at once, like most 
of us, you can have a different command-line 
history for each project. You can even create a 
text file of commands you like to use, then 
load them. 

You can also tell UNIX just how much 
history you want to store by setting the 
HISTSIZE variable. This tells how many 
commands will be available to you between 



sessions. Normally, this defaults to 128 
commands. 

Conclusion 

UNIX provides three different, but related, 
mechanisms for giving you the ability to work 
with a command-line history. In this article, 
we've explored command-line history for the 
Korn shell. Next month, weTl take a look at 
command-line history in the C shell. ❖ 



SYSTEM CONFIGURATION 



Orderly shutdovun during extended 
power faiures 



By Jerry L. M. Phillips, M.S. 

Do you depend upon your organization's 
auxiliary service departments or indivi- 
dual users to call you when your Sun 
equipment loses AC power during the night or 
on weekends? Do the calls ever come too late to 
permit an orderly shutdown of your Solaris 
operating systems? Worse yet, do you discover 
power losses after you return to work? If so, a 
time-saving alternative is available. 

Following the last prolonged weekend 
power outage at my campus, which I heard 
about 10 hours after the fact, I spent two ag- 
gravating days stabilizing the file systems 
on a crashed Usenet News-World Wide 
Web server. This prompted my search for a 
solution that offered timely, dependable no- 
tification of long power failures and an or- 
derly shutdown and remote reboot of the 
affected systems. 

In this article, I recommend a hardware 
and software combination that solved my 
problems. The combination includes an 
American Power Conversion (APC) Smart- 
UPS 700, an APC Call-UPS II remote control 
accessory, a Measure-UPS II supplementary 
surveillance accessory, and APC PowerChute 
Plus v4.2.1 for Solaris software. 

Here's how it works 

The process is fairly straightforward. The 
Smart-UPS 700, attached to your Solaris/ 



SPARC system, registers a power disturbance 
and switches to battery operation. If AC 
power doesn't resume within a few minutes, 
the Call-UPS II initiates a paging sequence. It 
uses a modem that you attach to the Call-UPS 
to dial a pager number. Your pager receives 
the call and displays the site ID with a Smart- 
UPS event status code indicating that the 
Smart-UPS is on battery. 

You may then dial into the Call-UPS II 
from a remote workstation to examine the 
event log and also check the load parameters 
on the Smart-UPS. In the meantime, the UPS 
status changes to low battery. Realizing that 
you can't respond onsite in time, you may tell 
the Call-UPS II to shut down the system 
gracefully and turn off the UPS. When power 
resumes, your system reboots automatically. 
Now, let's go through the steps necessary to 
configure the Call-UPS II and PowerChute 
Plus software. 

Call-UPS II configuration 

Following installation and testing of the Smart- 
UPS, connect the Call-UPS cable (marked UPS 
on the connector) to the computer interface 
port on the UPS. Next, connect the /dev/ttya se- 
rial port on your Solaris /SPARC computer to 
the Call-UPS management port using the null 
modem cable provided. This temporary con- 
nection will allow you to configure various 
parameters on the Call-UPS. 
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In our example, you'll configure the 
management port to send pages via modem 
and accept dial-in calls. Enter the command 

$ /usr/sbin/eeprom 1 grep ttya 

and confirm that the default values of the 
serial port selected are 

ttya-rts-dtr-off=false 
ttya-i gnore-cd=true 
ttya-mode=9600,8,n,1,h 

If your results do not agree with the 
parameters on the third line above, enter the 
command 

$ eeprom ttya-mode=9600,8,n, 1 ,h 

This will configure your port so it can communi- 
cate with the Call-UPS. Check your /etc/remote 
file — you need to be sure that you have the se- 
rial port configured properly. You may need to 
edit the file and insert the following line before 
executing the t i p command: 

cuaa :dv=/dev/cua/a:br#9600 

If everything is ready, you can access the Call- 
UPS through the port by entering the command 

$ tip cuaa 

Now, press [Ctrl]-?, and the Call-UPS 
should respond with the Enter Password> 
prompt. Type in the uppercase letters APC 
and press the [Enter] key. The Smart-UPS 700 
banner page should appear. Press any key to 
continue, and the Smart-UPS 700 should 
display the MAIN MENU, shown in Figure A. 

Select Call-UPS Settings (item 4), and you 
should see the CALL-UPS SETUP screen 
shown in Figure B. Follow the Call-UPS user's 
manual instructions to enter the Date, Time, 
and Location settings. Change the Answer 
Ring setting to 1 or 2. This setting represents 
the number of rings your modem waits before 
answering an incoming call. 

For the purposes of this article, weTl ig- 
nore the Dial Back, Dial Back Str, and Answer 
Lockout settings. These manage dial-back se- 
curity and control communication sessions 
over multiple devices using the same tele- 
phone line. After you get your system work- 
ing, you may want to explore these settings 
for added security for your UPS. (You prob- 
ably wouldn't like a spiteful worker or stu- 



dent hacking into your UPS and turning off 
your system.) 

Now select item 11, the Pager Setup 
Menu. When you do so, the Call-UPS will 
display the PAGING SETUP screen, shown in 
Figure C. Here, you configure the Call-UPS to 
page you if there is a change in the Smart-UPS 
status. You enable paging by changing the 
Paging setting to ON. 

The Dial String 1 setting stores the pager 
number and modem commands to dial your 
pager. This will depend on the type of modem 
you use. Our example uses a standard Hayes- 
compatible modem, so the DT means dial with 
touch tone; then we send a 9 to get an outside 
line. The comma tells the modem to pause for 
two seconds. Then comes our pager number. 





^ Li cmdtool (CONSOLE) ~/sbifi/sh J 


^f^j^ f^^l^y 




Date: Sep-11 '9G Time: 18:36:05 




1- UPS Status 1 

2- UPS Control 1 

3- Data/Event Logging 1 

4- Call-UPS Settings 1 

5- UPS Characteristics 1 

6- Measure-UPS Status 1 
?- Help 1 

<CR> Display Menu 1 
<ESC> End Session 1 










Once you're communicating properly with the Call-UPS, you should see the 
MAIN MENU. 


gjjjj^^ 


f Hi cmdtool (CONSOLE) -/sbin/sh 


5- 


CALL-UPS SETUP - 

Model Number: AP9208 H/W Rev: C3 
Serial Number: A95056435648 F/W Rev: E 
Manuf. Date: 6/8/95 


_J 


1- Set Date: Sep-11 "96 7- Ansi Color: ON 

2- Set Time: 18:38:06 8- Baud Rate: 19200 

3- Set Password: ******** 9- Answer Ring: 1 

4- Dial Back: OFF 10- Answer Lockout: 0 min 

5- Dial Back Str: DT5551212 

6- Location: EVMS Academic Computer Center 


r 


11- Pager Setup Menu 

12- Reset Call-UPS to Default Settings 
?- Help 

<CR> Display Menu 
<ESC> Return to Previous Menu 









You use the CALL-UPS SETUP screen to set up the date, time, and 
communications settings. 



Inside Solaris 



Finally, we use the @ to tell the Call-UPS to 
wait five seconds before continuing. 

Whenever the UPS status changes, the 
Call-UPS will call the number specified by 
Dial String 1 and then send the site ID num- 
ber, the space character (specified by item 9), 



Figure C 




If 



cmdtool (CONS OLD ~7sbln/sh 



Paging: 
Di al Stri ng 1 : 
Dial String 2: 

Repeat 1 : 

Repeat 2: 
Page Interval : 1 mi n 
Message Delay: 15 sec 



- PAGING SETUP 
ON 

DT9,4755371(& 
DT9,5551212@ 
1 8- 
1 9- 



Site ID: 
Space Char: 



4465834 



10- Dial Speed: Slow 



EVENT 



PAGE NUM: 1 2 



CODE 



11- UPS ON-BATTERY Y N 

12- ON-BATT & LOW-BATT Y N 

13- UPS SHUT DOWN Y N 

14- UPS ON-LINE Y N 

15- REPLACE BATTERY Y N 

16- UPS FAULT Y N 

17- MEASURE-UPS ALARM Y N 

18- MEASURE-UPS ALL CLEAR Y N 

?- Help 

<CR> Display Menu 

<ESC> Return to Previous Menu 



You can choose which events are important enough to page you with the 
PAGING SETUP screen. 



Figure D 



cmdtobi -/sbln/sh 

Run Time Utility 



omtonng: Quarton 
UPS Model: Smart-UPS 700 
Status: On Line 



UPS Self Test: Passed 
Last Test Date: 08/24/9G 



UPS Output: 
Line Minimum: 
Line Maximum: 
UPS Temp 
Output Freq: 
Ambient Temp: 
Humidity: 



121.5 VAC 
89.4 F 

60.00 Hz 
71 .8 F 
52.0 % 




I 



23 min 



09/11/9G 15:59 



.— Last Two Events: 

I09/0G/96 14:19:21 UPS on battery: Blackout 000.0 V 
I09/06/9G 14:22:24 Normal power restored: UPS on line 



I 
I 

<''''G> Menu — <'H> Refresh — 'i 



The PowerChute software allows you to monitor the status of the UPS at 
any time. 



followed by the numerical code corresponding 
to the UPS status. You can also configure a 
second pager number into Dial String 2 to 
make the system call another pager. 

At the bottom of the PAGING SETUP 
screen, you can configure which error conditions 
will trigger a page and on which pager. You 
may choose to have some conditions call both 
pagers, some call only pager 1, and others call 
only pager 2. In this instance, we're sending all 
events to pager 1 only. 

If you're paranoid about your pagers, you 
can also tell Call-UPS to repeat your pages, 
along with an interval between pages. This 
way, if your pager line just happened to be 
busy the first time it attempts to call, it should 
get through the second (or third...) time. 

Now that youVe configured the pager 
settings, press the [Esc] key twice to return to 
the MAIN MENU. Essentially, the Call-UPS II 
configuration is complete. 

Other items on the MAIN MENU allow 
you to configure some advanced options, as 
well as examine many details about the UPS 
operation, such as utility line input, UPS 
output, UPS load, run time, UPS temp, freq, 
last UPS transfer to battery, voltage, battery 
capacity, date of last battery change, and 
results of last self test. 

When you call in from a remote location, 
youTl use the UPS Control menu. From this 
menu, you can turn the UPS on and off, run a 
self test, simulate a power failure, and grace- 
fully shut down the attached computer. 

To end the session, press the [Esc] key, type 
yes to confirm and save your configuration 
changes, and press [Enter]. Type ~. (tilde period) 
to terminate the t i p program. Disconnect the 
null modem cable from your serial port and 
from the Call-UPS Management port. 

PowepChute Plus configuration 

The next step is to install the PowerChute Plus 
software. Its features include scheduled server 
shutdown, interactive /scheduled battery 
testing, detailed power quality logging, and 
real-time graphical displays that show battery 
voltage, battery capacity, UPS load, utiHty line 
voltage, and run time remaining. 

The PowerChute software consists of two 
modules. The first module is a UPS monitoring 
module daemon (upsd) that executes as a back- 
ground process and communicates with the 
UPS via a serial port. The second is a user inter- 
face module that provides system monitoring. 
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logging, configuration, and diagnostic capabili- 
ties from the computer. 

The software comes with cables and serial 
port adapters. Connect serial port /dev/ttya to the 
UPS monitor port on the Call-UPS. Follow the 
detailed PowerChute Plus user's guide to install 
the software. It requires some familiarity with 
two UNIX port management tools — pmadm and 
sacadm. YouTl have to disable logins on the serial 
port that PowerChute uses to communicate with 
the UPS. 

First, weTl disable the default port monitor 
on /dev/ttya by executing the command 

$ sacadm -d -p zsmon 

Now weTl disable the service that controls the 
/dev/ttya port monitor with the command 

$ pmadm -d -p zsmon -s ttya 

Once you're finished, you should list all 
the port monitors and services on the system 
to ensure that you've properly turned them off 
for /dev/ttya. You can list all port monitors on 
the system by using the command 

$ sacadm -I 

Similarly, you can list all services on the 
system by using the command 

$ pmadm -I 



appear as shown in Figure D. Please note the 
Ambient Temp and Humidity parameters: The 
Measure-UPS performs temperature sensing, 
humidity sensing, and contact monitoring, and 
provides this data to the Smart-UPS. Type 
[Ctrl]-G to access the different menu options. 



Figure E 




utility 



UPS Load 



Mom ton ng: Quarton 
UPS Model: Srnart-UPS 700 
Status: On Line 




140 I 



I 125 I 
I I 



UPS Ou 
Line Min 
Line Max 

UPS 
Output 
Ambient 
Humi 



UPS Low Battery Signal Time <02 > minutes 

UPS Turn Off Delay <020 > seconds 

UPS Wakeup Delay (Time} <180 > seconds 

UPS Wakeup Delay (Capacity) <00 > % 

UPS Audible Warning <Power Fail 

[+] Automatic Reboot 



I Cancel 



I 



09/11/96 16:03 



. — Last Two Events: 

109/06/96 14:19:21 UPS on battery: Blackout 000.0 V 

109/06/96 14:22:24 Normal power restored: UPS on line 

^AG> Menu 



■^L> Refresh 



You use ttiis screen to configure the basic parameters for ttie UPS. 



Disabling serial port logins will remain in 
effect only until you shut down the computer. 
You may choose to remove the port monitors 
and services or create a file in /etc/rc2.d that 
disables port logins at startup. 

The installation process modifies the file 
/sbin/rcO and also creates the file /etc/rc2.d/ 
S98upsd that starts and stops the upsd dae- 
mon. The daemon will start automatically 
during system boot, or you can issue the com- 
mands below as needed: 

$ /etc/rc2.d/S98upsd start 
$ /etc/rc2.d/S98upsd stop 

You start the character-based user inter- 
face module by typing 

$ /usr/lib/powerchute/powerchute 

Press the spacebar to accept the UPS online 
prompt. Then, enter the password for the 
account you're using and press the [Enter] key. 
The PowerChute user interface module will 



Figure F 




if 



cmdtoo I ~ /s b i n/s h 



utility 



UPS Load 



Monitoring: Quarton 
UPS Model: Smart-UPS 700 
Status: On Line 



I 140 I 

I I 



UPS Self+ 
Last Testl 




.UPS Communications , 

I C ) Simple Signalling | 
I (o) Smart Signalling I 
I I 
I Communications Port [/dev/ttya ]* I 



Paging Modem 

C ) Pulse 
Co) Tone 

Communications Port [/dev/ttya 

Baud Rate <19200 

Initialization [ 



I Cancel 



I 



09/11/96 



. -- Last Two Events: 

109/06/96 14:19:21 UPS on battery: Blackout 000.0 V 
109/06/96 14:22:24 Normal power restored: UPS on line 

<AG> 



<^L> Refresh 



You configure ttie communications port tfie UPS is connected to witti ttiis 
configuration screen. 



inside Soiaris 
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Press the right arrow key to highlight the 
Configuration menu item. Press the down arrow 
to highlight UPS Shutdown Parameters, then 
press the spacebar. When you do so, you'll see 
the screen shown in Figure E on the previous 



Figure G 



38 



ctndtooi -/sbin/sri 



Run Time 



Utility 



UPS Load 



I liMllUdlHSISIllEBaBBIl^— 1 



I 140 I I 125 I I 

II II I 
> < I 1 



I Teresa A. Goodwin 
l>fl~ 



10 [Jerry L.M. Phillips M.S. 
I<ll 

II 

-'v <Add > <Rename> <Delete> 



. Messagi ng 

I [ ] Enabled 

I Notification Address [jerryj . rn._phi 1 1 i ps_m. s. 

. Pagi ng 

I [+] Enabled 

I Access Number [94755371 
I Access Code [ 



Pager Service 
] <MobileMedia 
] <Edi t Servi ces. . > 



.E-Mail 

I [+] Enabled 

I E-Mail Address [jerry@troi . evms. edu| 



I Cancel 



+========== 



.-- Last Two Events: 

109/06/96 14:19:21 UPS on battery: Blackout 000.0 V 
109/06/96 14:22:24 Normal power restored: UPS on line 



<AG> Menu — <al> Refresh — ' 



The Configuration Event Users screen allows you to set the E-mail addresses 
to notify about UPS changes. 



Figure H 



page. Now use the [Tab] key to move within 
the dialog box. Please note that we set the con- 
figuration as shown in Figure E. When you 
finish, press [Tab] until you get to the OK 
button, then press the spacebar. 

Next, we need to tell PowerChute which 
communications port the UPS is connected to. 
Select Configuration Communications Param- 
eters and use the settings shown in Figure F 
on the previous page. Please note: The paging 
modem function didn't work for me! APC 
technical support recommended using the 
Call-UPS II instead. A future version of Power- 
Chute may support the paging modem option 
without the Call-UPS. 

You can tell PowerChute to inform people 
about changes in the UPS status with the 
Configuration Event Users menu item, shown 
in Figure G. Select Configuration Event Users 
from the MAIN MENU, and enter settings 
appropriate to your site. As you can see, you 
can enable E-mail and paging. 

Finally, we need to tell PowerChute 
what to do when a specific event occurs. To 
do so, select Configuration Event Actions 
from the MAIN MENU. When you do, youTl 
see the screen shown in Figure H. On the left 
side of the screen is a list of events, and on 
the right is a set of actions you can trigger 
when the selected event occurs. Figure H 
shows that the software will write a log 
entry and send E-mail in response to the 
UPS On Battery event. 



If 



Utility 



UPS Load 



Events 



PowerChute Started 
PowerChute Stopped 



Power Restored 
Low Battery Condition 
UPS Battery Is Discharged 
UPS Return From Low Battery 
Communication Established 
Unable To Communicate With UPS 
Comm Lost While On Battery 
Administrative Shutdown 
System Shutdown Starting 
System Shutdown Complete 
Shutdown Cancelled 
UPS Output Overload 
UPS Overload Condition Solved 



I 140 I 
I I 



I 125 I 
I I 
< I 



I 



Actions for Selected Event 

+1 Log Event 

] Notify Administrators <Options> 
] Notify Users <Options> 
] Run Command File <Options> 
+1 Send E-Mail <Options> 
+] Page Users <Options> 
] Shut Down Server <Options> 
<Reset To Default Actions... > 



I Cancel | 



.-- Last Two Events: 

109/06/96 14:19:21 UPS on battery: Blackout 000.0 V 
109/06/96 14:22:24 Normal power restored: UPS on line 



<'^G> Menu ~ <^l> Refresh 



PowerChute allows you to execute a wide variety of actions on any or all 
events. 



Test your setup 

Once you get your system set up, you should 
test it. Make sure that you're not running 
anything critical, and unplug your UPS. You 
should receive a page that shows the site ID 
and event status code. You should also re- 
ceive E-mail if you configured your system to 
send it. Finally, you should call into the Call- 
UPS module to test its configuration and 
modem connection. 

Conclusion 

If you can't afford the time it takes to re- 
build your file systems, you need to ensure 
that your system doesn't go down unex- 
pectedly. While you can't ensure 100 percent 
up time, a UPS with good support software 
can go a long way towards giving you peace 
of mind. 




November 1996 



MONITOR YOUR SYSTEM 



Who has an account on your system? 



If you're like me, you sometimes need to 
see who has an account on a particular 
machine. Obviously, you can just take a 
look at the /etc/passwd file and see. Figure A 
shows an /etc/passwd file. However, you have to 
ignore the entries that don't correspond to a 
user account, and let's face it, the /etc/passwd file 
is ugly. In this article, we're going to present a 
small script that will print a list of the user 
accounts on your machine in a nicer format, 
sorted alphabetically by the login name. 



Figure A 

root :x:0:1 : Super-User: /: /sbin/sh 

daemonix: 1 : 1 : : /: 

bin:x:2:2: :/usr/bin: 

sys:x:3:3: : /: 

adm:x:4:4:Admin: /var/adm: 

lp:x:71 :8:Line Printer Admin:/usr/spool/lp: 

sintp:x:0:0:Mai I Daemon User:/: 

uucp:x:5:5:uucp Admi n : /usr/ U b/uucp : 

nuucp:x:9:9:uucp Admin: /var/spool/uucppublic: / 

^usr/ 1 i b/uucp/uuci CO 
M sten:x:37:4:Network Admi n : /usr/net/n Is : 
nobody :x: 60001 : 60001 : Nobody : / : 
noaccess:x:60002:60002:No Access User:/: 
marco:x: 100: 10:Mai n user : /export /home /ma r co : / 

^bin/ksh 

fred:x:101 :10:Test user : /export /home/ f red : /bi n/ 
^csh 

Thie /etc/passwd file contains all the information you 
need, but it's not easy to read. 



As you can see in Figure A, the entries in 
the /etc/passwd file are in no particular order. 
We also see that the first entry in each record 
is the login name of the user. Since we want to 
alphabetize our list, the first step is to sort the 
/etc/passwd file, like this: 

$ sort </etc/passwd 

Now we want to take the resulting file 
and print it out in a prettier format. The awk 
tool is the best choice for the job. It's designed 
to read a text file one record at a time, where a 
record is a single line, and break it into fields. 
Then you can process the record according to 
the rules you hand awk. (If you're unfamiliar 



with awk, see the article "An Introduction to 
awk" in our May issue.) 

However, awk normally breaks a record 
into fields at white space. Thus, it interprets 
the line 

now is the time 

as a record containing four fields. Unfortu- 
nately, the /etc/passwd file doesn't lend itself to 
processing like this. A record doesn't neces- 
sarily contain spaces, and when it does, 
they're not at field boundaries. For example, 
this line has two spaces, but they both appear 
in the comment field: 

lp:x:71 :8:Line Printer Admi n : /usr/spoo I / Ip : 

The /etc/passwd file is arranged such that 
each line contains seven fields, separated by 
colons. The field definitions are shown in 
Table A. 



Table A 


Field 


Description 


1 


The user's login name 


2 


The encrypted password (archaic, now used for 
pwconv maintenance) 


3 


User ID 


4 


Group ID 


5 


Comment field, it often holds the user's full name 


6 


Home directory location 


7 


Login shell to use 



Ttiese are the field definitions for the /etc/passwd file. 

If we could tell awk to split records apart 
using a colon rather than white space, printing 
our report would be a simple task. Luckily, 
you can tell awk the character to use to split a 
record apart with the -F switch. Simply use 
-F?, where ? is the character to use as a field 
separator, like this: 

$ sort </etc/passwd I awk -F: ' { print 
^$1,$5,$7 } ' 
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SECOND CLASS MAIL 



SunSoft Technical Support 
(800) 786-7638 



Please include account number from label with any correspondence. 



Figure B 

# ISOLusers - Display the username, comment 

# and shell each user on the system. 

sort </etc/passwcl I awk -F: ' 

# Print column headers 
BEGIN { 

printf "%-8.8s "UserName" 
printf "%-25.25s \ "Comment" 
printf "%-24.24s\n", "Shell" 

printf "%8.8s ", " " 

printf "%25.25s ", " " 

printf "%24.24s\n", " " 

} 

# Process each record that has a shell entry 

# (This is how we differentiate a user from a 

# daemon or other entry in /etc/passwd . ) 
length($7)>0 { 

printf "%-8.8s %-25.25s %-24.24s\n",$1 ,$5,$7 

} 



The ISOLusers script prints an alphabetized list of all 
user accounts on your system. 



This command prints out the user's login 
name, comment field, and login shell. Now 
all we need to do is fine-tune it to make it 
prettier, and we're done. To do so, we use 
a wk's printf command, so we can force the 
columns to be fixed width. We also added 
column headings to make the report nicer. 
The last thing we did was tell awk to only 
print records for the users who had a shell 
defined. This way, you don't have to look 
through the daemon processes and other en- 
tries that don't correspond to user accounts. 
Figure B shows the finished script, named 
ISOLusers. 

Conclusion 

We've presented a simple script you can use 
to find out who has an account on your sys- 
tem. For our purposes, we needed only the 
user name, comment, and shell, but you can 
modify it to suit your own needs. Now you 
don't have to weed through the /etc/passwd 
file in search of a user's account. The script 
ISOLusers will print a neat list for you. ❖ 



LETTERS 



More directory switching vuiUi the Kom sheli 



Your quick tip entitled "Quickly Switch 
Between Directories" in the July issue was 
good, but it might have been worth mention- 
ing another feature of the Korn shell. In par- 
ticular, you might have discussed the ability 
to define CDPATH and the use of cd - to jump to 
the previous directory. 

Glen 

via the Internet 

Glen, thanks for pointing that out. Each time 
you change directories in the Korn shell, it stores 
your new working directory in the PWD envi- 



ronment variable. It also stores your previous 
working directory in the OLDPWD variable. 

So one way to change to your previous 
directory is to use the command 

$ cd SOLDPWD 

As you noticed, however, the Korn shell gives 
you an even simpler method of switching back 
to your previous directory. The implementers of 
the Kom sheU gave the shorthand notation of cd -, 
which tells the Korn shell to change to the direc- 
tory stored in the OLDPWD environment variable. ❖ 
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